資金異動訊息

介面描述

取得對指定代幣在中心化交易所上，現貨或合約交易的主力資金異動的監控訊息記錄。

使用情境：

• 適用於資金異動監控列表下的代幣，在AI即時追蹤過程中的訊息查詢
• 適用於檢視歷史資金異動訊號記錄，包括但不限於短線/趨勢行情異動、Alpha、FOMO 、止盈、止損等

使用提示：

• 訊號類型需展示名稱，出現多個alpha，fomo等訊息時，統計各自出現的次數，同時出現時特別提醒
• 自然語言查詢異動代幣後，或查詢異動訊號，呼叫此介面
• 與資金異動代幣列表介面配合使用，資金異動代幣里的代幣訊號查詢才查呼叫此介面

資料更新頻率：每5分鐘更新一次

請求 URL

• 方法：POST
• 路徑：/open/v1/ai/getFundsCoinMessageList

點數消耗

• 消耗點數：5

前置條件

取得 vsTokenId

條件	說明	取得方式
已有 vsTokenId	直接使用快取的 vsTokenId，無需重複查詢	上下文自動提取
未有 vsTokenId	呼叫 POST /vs-token/list 介面取得	前置介面呼叫

請求參數

參數透過請求體（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID
tradeType	integer	是	交易類型（1:現貨, 2:合約）

列舉值說明

tradeType - 交易類型

值	含义
1	現貨
2	合約

回應欄位

僅展示 data 陣列內每個物件的欄位結構：

欄位	類型	實際回傳類型	描述
updateTime	long	long	更新時間（毫秒時間戳）
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符號
name	string	string	名稱
tradeType	integer	integer	代幣類型（1:現貨; 2:合約; 3:交割合約）
price	number	string	幣價
percentChange24h	number	number	24 小時漲跌幅
fundsMovementType	integer	integer	資金流動類型

欄位業務含義

欄位	業務含義	使用建議
fundsMovementType	資金異動類型	識別資金異動類型，如短線行情異動、趨勢行情異動、Alpha等，同一時間多個類型時，可特別提醒，訊號類型的對應關係不展示

請求範例

{
    "vsTokenId": 22974,      // 代币 id
    "tradeType": 1           // 交易类型（1:现货, 2:合约）
}

cURL 範例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/ai/getFundsCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 22974,
    "tradeType": 1
}'

cURL 範例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/ai/getFundsCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 22974,    \"tradeType\": 1}"

成功回應範例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773395700000,       // 更新时间
            "vsTokenId": "22974",                // 代币 ID
            "symbol": "TAO",                      // 代币符号
            "name": "Bittensor",                  // 名称
            "tradeType": 1,                       // 代币类型（1:现货; 2:合约; 3:交割合约）
            "price": "241.4",                     // 币价
            "percentChange24h": 15.36477852,      // 24 小时涨跌幅
            "fundsMovementType": 6                // 资金流动类型（6:涨幅）
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 4.56494468,
            "fundsMovementType": 3
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 15.6226012,
            "fundsMovementType": 1
        }
        // ... 更多数据省略
    ],
    "requestId": "xxx-xxx-xxx"
}